Document the "desktop-folder" binding signal.

2005-10-04  Federico Mena Quintero  <federico@ximian.com>

	* gtk/tmpl/gtkfilechooser.sgml: Document the "desktop-folder"
	binding signal.

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 7e7293aca8d7b3ed299b59d718c8abaed73e777c..c4582bb02ee22cbb1cbc0b99ebfe4445c055aaf9 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,8 @@
+2005-10-04  Federico Mena Quintero  <federico@ximian.com>
+
+       * gtk/tmpl/gtkfilechooser.sgml: Document the "desktop-folder"
+       binding signal.
+
 2005-09-26  Matthias Clasen  <mclasen@redhat.com>
 
        * gdk/tmpl/gcs.sgml: Fix a comment.

diff --git a/docs/reference/gtk/tmpl/gtkfilechooser.sgml b/docs/reference/gtk/tmpl/gtkfilechooser.sgml
index 567cb9fb4ed62c0905f2c217e94ffd5ac41675e3..413756c5443a79a1974f4dbc190545b0f55d8272 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkfilechooser.sgml
+++ b/docs/reference/gtk/tmpl/gtkfilechooser.sgml
@@ -234,6 +234,10 @@ update_preview_cb (GtkFileChooser *file_chooser, gpointer data)
                <entry>home-folder</entry>
                <entry><keycombo><keycap>Alt</keycap><keycap>Home</keycap></keycombo></entry>
              </row>
+             <row>
+               <entry>desktop-folder</entry>
+               <entry><keycombo><keycap>Alt</keycap><keycap>D</keycap></keycombo></entry>
+             </row>
            </tbody>
          </tgroup>
        </informaltable>
@@ -447,6 +451,40 @@ class "GtkFileChooserDefault" binding "misc-shortcut"
          </varlistentry>
        </variablelist>
       </refsect3>
+
+      <refsect3 id="GtkFileChooserDefault-desktop-folder">
+       <title>The &quot;GtkFileChooserDefault::desktop-folder&quot; signal</title>
+
+       <programlisting>
+          void user_function (GtkFileChooserDefault *chooser,
+                              <link linkend="gpointer">gpointer</link> user_data);
+       </programlisting>
+
+       <para>
+         This is used to make the file chooser show the user's Desktop
+         folder in the file list.  By default this is bound to
+         <keycombo><keycap>Alt</keycap><keycap>D</keycap></keycombo>.
+       </para>
+
+       <variablelist role="params">
+         <varlistentry>
+           <term><parameter>chooser</parameter>&nbsp;:</term>
+           <listitem>
+             <simpara>
+               the object which received the signal.
+             </simpara>
+           </listitem>
+         </varlistentry>
+         <varlistentry>
+           <term><parameter>user_data</parameter>&nbsp;:</term>
+           <listitem>
+             <simpara>
+               user data set when the signal handler was connected.
+             </simpara>
+           </listitem>
+         </varlistentry>
+       </variablelist>
+      </refsect3>
     </refsect2>
 
 <!-- ##### SECTION See_Also ##### -->